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Th« CA-ACUL proqraiB 13 B-mn :^^ to the 5? the 

and b nary on the tm>e» To venerate a new binary file If the 
source proqram is rao^lfier^, xsa the following pro't-jdure. 

1. Load a DIAL-MS tape on unit 0* I/>ad unit 1 with 
either a DIA3>V2 or DIAL-MS evstera tape. If another 
tape unit is av ailable, raount the tat>e containing the 
CLEAPSYM an<3 CJ.ThCkL source programs there. If only 
two tape units are avallall®. place the source prograraa 
on unit 0 (with PI? if v@cifeaty)f in ordar to reduce 
the aB9«nbly tin&. 

2. Tyi>e->ZEj to clear the Mr ry worklnq Area of unit 1. 

3. Tn>«-* ASjlCLEARSYM . CLEARSYM i« a two wcrd program 
which produces a else-* cymbol table. 
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4. Tyi>«-»AS ChT2^0l « Error nessages generated at this 

time should be ignored. Press the RSTURN )cey to teminate 
the assembly after the errors haw all been printea ro 
suppress printing of the symbol table. 

5. Type-^ZE^. 'This clears the binary working Area on unit 1. 

6. Type^LI ChT3M. If no listing is desired, use the AS 
coamand. Any errors generated now are real and must be 
corrected. 

7. Typ«->LI ChT2p0l. Pecausa the symbol table produced Is 

the same as the one generated in step 6, printing may 
be suppressed with the RETURN Jcey after it has started 

to be printed. 

I?. Type4SB CAT23.^^. This saves the binary output from 
the two previous assemblies. 

9. Type^Z]^. 

10. TWO versions of the Floating Point Package ace 
supplied. If the machine has the EAE option, CATIB 
should be used In the following cteps ano. GATACAL* will 
be generated, if ^h® machine do<?s not have this opt.. on, 
CAT2 Should b® usee' to generate CATACAL. 

11. Typa^AB CATl, 0l» 

12. Type-^AB CAT23,J^i. 

1>. Type^SB CATACAL,^?Pi . A binary file of J 

now been qen#rated and comm^'^''MLO CATACAL. will cause 
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CHAPTER 1 
USING CATACAL 

1 . 1 Introduction 

CATACAL is a box-car averager for data acquisition at rates from 35 
seconds/point to 250 microseconds point"^. Any analytical instrximent or 
experiment supplying data within those limits can be interpreted 
easily and quickly using CATACAL *s many facilities. 

Initially, CATACAL accepts analog data from the interfaced analytical 
instruments, averages the information, and displays the averaged data 
on the PDP-12 oscilloscope. The scientist can then interpret the 
data as required by his experiment in seconds using any of CATACAL »s 
data handling commands. Thus, a sloping baseline can be aligned, a 
spectrum can be scaled, many integrations can be performed, and two 
spectra can be compared simultaneously, each operation requiring only 
a single command. 

An X-Y recorder can be interfaced parallel to a scope channel of the 
computer if hard copy results are desired, 

CATACAL is supplied in two versions " CATACAL and CATACALE. The 
only difference between the two is that the latter version uses EAE 
(Extended Arithmetic Element) for greater calculating speed. 

1.2 Hardware Requirements 

The minimum configuration for using CATACAL is: 

PDP-12A computer with 8K of core memory and KW12A clock 

An X-Y Analog Recorder is recommended for hard copy. 

The program does not require, but will support, a high speed reader/ 
punch. 



If a faster sampling rate is required, the Signal Averager program, 
DEC--12-Y2AA, can be used to collect the data and CATACAL can be used 
to interpret the supplied information. The TISA program, DEC-12-'UW3A, 
accepts asynchronous data which also can be manipulated by CATACAL. 
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1,3 Initial Starting Procedure; 



Each time the PDP-12 computer is to be used to run CATACAL, the fol- 
lowing procedure must be performed. 

1. Mount the CATACAL tape on tape unit 0. (Unit 0 is 
indicated by setting the tape channel indicator to 
8). Mount a scratch or library tape on unit 1. 

2. Set the switches on the tape units to REMOTE and 
WRITE ENABLE. 

3. Set the mode switch to LINC mode and press the I/O 
PRESET key on the computer console. 

4. Set the Left Switches to 0701 and the Right Switches 
to 73jei0. 

5. Press the DO console switch, 

6. When the tape has stopped moving/ press the START 
20 key. 

7. Press LINE FEED, type 

LO CATACAL, 0 

or 

LO CATACALE,0 

and press the RETURN key. Either program may be 
loaded. If only one program is to be used at all 
times, the other may be removed permanently from 
the tape. 

Refer to the LAP6-DIAL Programmer's Reference Manual, DEC-12-SE2B-D, 
for additional information on operating procedures. 

CATACAL indicates it has been successfully loaded into the computer 
by typing the message 

CALACAL LIVES! 
TITLE : 



Commentary of any length may be typed in after TITLE. The informa- 
tion is not stored with the data on tape and is used only to supply a 
titled paper copy record of data operations performed. Type CTRL/A 
to exit from the title phase. A coimnand may now be issued (refer to 
Chapter 2) . 

^CTRL/A is typed by pressing down the CTRL (control) key and then the 
letter key (A in this case) in the same manner as a character requir- 
ing the SHIFT key is typed. 
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1.4 Inputting Data 



Most calculations are performed with the Floating Point Package (refer 
to Floating Point System Manual, DEC--08-'YQyB-D) , but final array 
results are single precision (12 bit) integers, normally scaled to the 
range 0^1000^^^. when a numeric value is requested, most conventional 
formats are acceptable. Thus, for example, the decimal value 1^ may 
be entered as 10,0, 10, iei, or .lE+02, etc., as described in the 
above manual. After a numeric value has been typed in response to a 
command, any character except 0 to 9, E, or . will terminate input 
for that entry. A space is recommended as the terminator. (Pressing 
RETURN does not automatically generate a LINE FEED.) In response to 
questions, only Y or N are acceptable answers. Any other response 
generates a question mark on the Teletype and is ignored. No termina- 
tor is required after a Y or N response. 

In all cases, striking RUBOUT before a terminator will delete all in- 
put up to the preceding terminator to allow the correct value to be 
entered. A RUBOUT during decimal input echoes as an exclamation mark 
and during octal input as a question mark on the Teletype. 

If, during scope display, a command unacceptable to CATACAL is typed, 
a ? is printed on the Teletype and the program returns to the same 
scope display. 

At all times when using CATACAL, it is strongly recommended that any 

data, both raw and interpreted, that may possibly be used at a later 
time be saved on tape (see TAPE I/O, section 2.5) to prevent acciden- 
tal elimination from the display channel, because most commands re-- 
place the previous contents on the scope. 

1.5 Stopping and Restarting CATACAL 

If an operation must be halted immediately, press the console STOP 
switch. This should not be used haphazardly; if arrays were being 
modified the data will be lost. Routines requiring input parameters 
or initial dialogue can be halted during that stage and before the 
input is complete. To restart CATACAL after an emergency stop, set 
the MODE switch to 8 mode, set STOP switch to run position, and press 
I/O PRESET and then START 400 key. A new CATACAL command can be issued 
when the display is restarted. If the START 20 key is pressed instead 
of START 400, the program starts at the beginning as described in 
Section 1,3. 
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CHAPTER 2 
CATACAL COMMANDS 

2 . 1 Introduction 

After starting CATACAL (refer to Section 1.3), a scope channel should 
be designated to accommodate the incoming data which is loaded into 
the computer's memory area directly from an analog input channel, the 
Teletype keyboard, the high-speed or Teletype reader, or storage on 
LINCtape. Any of CATACAL' s conimands can then be used to interpret 
the data. For example, the baseline can be linearized and the result- 
ing spectrum integrated. 

Each CATACAL command is described in this chapter. The values re- 
quested, acceptable ranges, formulas used and available options for 
each are included in the discussion. After each conmiand is completed, 
the correct spectrxam is displayed (except the MODIFY command) . 
Another command may be issued at that time. 

2.2 Scope Channel 

The scope on the PDP-12 provides three viewing channels: 

channel 1 - assigned by user 
channel 2 assigned by user 
channel 3 - channels 1 & 2 simultaneously 

Data supplied from the associated instrument or from LINCtape is as- 
signed to channel 1 by typing the number 1 on the Teletype; similarly 
data is assigned to channel 2 by typing the number 2 on the Teletype. 
The choice of channels 1 or 2 determines which data will be used. If 
a number between 4 and 9 is typed, channel 1 is assumed. Typing 0 
produces a response of question mark on the Teletype. 

Each channel can accommodate up to 2000 data points. A channel may 
be assigned to accommodate data when a new spectrum is being collected 
or when another CATACAL command has been completed by typing 1 or 2. 
The present contents of that channel are displayed on the scope. 
When new data is assigned to a channel which already contains data, 
it replaces the old data. 

^Teletype is the registered trademark of the Teletype Corporation. 



2-1 



Channel 3 permits the user to view the data in channels 1 and 2 to- 
gether. When channel 3 is being used, analog knobs 0 and 1 control 
the X and Y offset for channel 2 to allow comparison of data sets. 
It can be viewed at any time between commands, but should be followed 
by a 1 or 2 before calling a command. If left at channel 3, the next 
command assumes channel 2. 

Most of the remaining CATACAL commands are called by typing at least 
the first two letters of its name and a colon after the termination 
of the preceding command. Refer to Appendix A for a summary of the 
commands . 

2 . 3 AVERAGE 

The AVERAGE command implements time averaged analog input from the 

associated instrument. The parameters of the scan are specified on 
the Teletype in response to AVERAGERS questions and then that opera- 
tion is performed. The data collected is displayed on the channel 
specified before the AVERAGE command was initiated. 

To collect data, proceed as follows. 

1. Prepare the analog instrument for the experiment. 

2. Specify a scope channel number (1 or 2) to accom- 
modate the data. 

3. Type AV: indicating an averaging operation is to 

be performed, 

4. The Teletype asks 

CHANNEL^ 

requesting the analog channel number (octal) to 
which the instrument is connected. Type in the 
analog channel number on the AD12 used by this 
experiment and press RETURN . Note that digits 
other than 0-7 will serve as terminators. 

5. The Teletype will respond with the message 

NO. POINTS= 

Type in the number of points to be collected in 
the scan where i2f<POINTS<2j348 and then press 
the SPACE bar. 
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6. The next question is 
SEC /SCAN= 



Type in a value for the length in seconds of each 
scan where SEC/SCAN= seconds/point x points/scan. 
Remember that a minimum of J0.25 millisecond/point 
is required. Press the SPACE bar. If the result- 
ant rate is too high [{SEC/SCAN/NO. POINTS) < 0.25 
msec], the routine restarts, asking for 



NO. POINTS= 



7. The program now asks for the desired external sense 
line {0"15g)^ and its state, which is to be used to 
trigger each scan. In response to 

SENSE: 



type the octal value of the desired sense line if 
the desired state is +3 volts. If the desired state 
is 0 volts, enter the sum of the sense line plus 2J2fg 
Sense line 15 is used by the Teletype. All uncon- 
nected sense lines are held at +3 volts • 



8. The next question is 
DELAY (SEC)= 



asking for the delay from receipt of the trigger 
pulse to the start of data acquisition for each 
scan. Values from 0 to 20 seconds are legal; 
resolution is 10 milliseconds. Press the SPACE 
bar after typing the value. 

9. The message 



NO. OF SCANS=: 



is asked last and the reply must be in the range 
l£SCANS<2j2(48. Type in the value and press the 
SPACE bar. Input will begin with the arrival 
of the first trigger pulse. 

10. Activate the instrument to begin the experiment. 
The AVERAGE command will now collect the data ac- 
cording to the specified parameters. 



The AVERAGER implements two display routines of its own, totally 
separate from the main scope routine of CATACAL. (This was necessary 
because of internal timing and intermediate data structure peculiar 
to the AVERAGER.) 



During data acquisition, the value for each point in the current scan 
is displayed as soon as it is available. Note that the X axis is not 
scaled to the number of points; thus, if less than 512 points were 
requested, the trace will wrap-around such that the 513th point will 
be displayed at the first location, the 514th at the second location, 
etc. 
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Bit 0 of the Riglit Switches can be set to 1 at any time during the 
run to interrupt the run when the current scan has been completed* 
The number of scans completed to that time is indicated by the mes- 
sage 

NO. SCANS= 

and the data are displayed on the scope. To diminish flicker, only 
one-fourth of the collected points are displayed. The Y axis can be 
doubled at this time by typing M? type D to halve the Y axis. By 
typing another message, 

MORE SCANS? 

is printed. Reply with Y if more scans are desired. Type N to ter- 
minate scanning with the specified parameters. This sequence of mes- 
sages is repeated until the number of scans requested in step 9 have 
been performed or until bit 0 is set to 0. If bit 0^0, the col- 
lected data is displayed only after all the scans are collected. 

2 . 4 TIME 

The constant corresponding to the computer's memory cycle time used 
to determine timing accuracy for averaging during data acquisition 
may be reset. The AVERAGE routine may be calibrated as follows. 

1. Call the MODIFY routine. Refer to section 2.24. 

2. Place 7402 in location 4307 to stop when com- 
pleted. This routine appears as follows on 
the Teletype. (The underlined data is typed 
in by the user.) 

MO: 

4MZ«443JZf:7402C 
RW 

The display is restored. 

3. Call the AVERAGER by typing AV: then use the values 
CHANNEL 0, 1000 POINTS, 16 SEC/SCAN, 15 for SENSE 

to allow the keyboard to initiate (trigger) the run, 
0 for DELAY, and 10 for NO. SCANS. Set bit 0 of 
Right Switches to 0. 

4. Time the program from when the keyboard is struck 
to when the computer halts, approximately 160 
seconds later. Call this value T. The memory 
cycle time, MCT, is then determined by 

MCT - T X .^'^ ^^^^ = T X 10^^ sec. 
16 X 10 
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1.6 microseconds is the value assumed by CATACAL, 
Restart the display by pressing the START 400 
switch as described in Section 1.5. 



5, Enter the desired value by typing TI : and sup- 
plying the value of MCT after the message 

MCT(SEC)= 

6. Call the MODIFY routine and replace the correct 
value in location 43j2f7. Once calibrated, the 
new value for MCT should be entered as in step 5 
above each time CATACAL is loaded from the DIAL 
system, if the AVERAGER is to be used. 



2.5 TAPE I/O 



LINCtape provides the PDP-12 with large data storage capabilities, each 
tape block holding 256 single precision data points. When the system 
has been properly started, a LINCtape on any tape unit can be used to 
store any collected data, either when it is collected initially by 
AVERAGE or after it has been manipulated by any of the CATACAL com- 
mands. Similarly, any stored single precision (12 bit) data can be 
retrieved from LINCtape at any time. Both data storage and retrieval 
use the same command, as follows: 



1. Type TA: to call the TAPE routine. 

2. The Teletype responds with 

BLKl, U,M, (J3=W) : 

This statement requests the following information 
when data is to be retrieved from tape: the first 
tape block number (octal) where the data starts, 
the number of the tape unit (0-7) holding the tape, 
and the mode of operation. Type in the three re- 
quested parameters, separated by a conuna or space. 
If a non-octal (not 0-1) digit is supplied for block 
number, 0 is assumed; however, data can not be read 
or written on LINCtape block 0. To request that 
block will merely repeat the question. Remember 
that each LINCtape contains 777g blocks. The mode 
for data retrieval is READ and is indicated by 
typing the number 1 for that parameter. 

If data is to be stored on tape, either immediately 
after collection via AVERAGE or after interpreta- 
tion, the parameters requested are the same as 
above, except that the mode of operation is 0 for 
WRITE. When the tape WRITE operation is completed, 
the data is redisplayed. If the exact location of 
stored data or of empty blocks is not known, use 
the MAGSPY program to determine it. (Refer to 
DEC-12-UZSA-D) . It is the user's responsibility 
to space the data files properly. 
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3. When the tape parameters have been accepted by the 
computer for a READ operation only, 

NO. POINTS^ 

is printed on the Teletype, Type the number of 
points to be retained for this spectrum and press 
RETURN. Any number of points up to 2j047 can be 
read in {mode=l) , not including those to be skipped. 

4. The final message is 

PTS. TO SKIP= 

If some points are to be skipped before the desired 
portion of the spectrum, type that value now and 
press RETURN. Type 0 if no points are to be skipped. 
Up to 2047 points can be skipped during a tape READ, 
operation. The tape READ operation is then performed 
after step If a value greater than 2047^^ is 

^ '''' ^' ^^^^ assumed. If,^^ during 
TAPE I/O, the program halts at location 3717, a 
checksum error has occurred due to a hardware mal- 
function or tape error. The program can be restarted 
by pressing the START 400 switch as described in Sec- 
tion 1.5. The transfer can be retried, if desired. 

2.6 PAPER TAPE 

Data may be input to the computer from papertape via the high or low 
speed reader. The data^ may have been punched directly by the ana- 
log instrument or may have been prepared by the CATACAL command 
OUTPUT. The procedure for inputting data from tape is as follows. 

1. Type PA: to call the routine. 

2. Answer the message 

NO. POINTS= 

With a value less than 2j34 8, not including skipped 
points . 

3. The next request is for 

PTS TO SKIP= 

Type in the number of points to be skipped from the 

^^P® before data is retained (less than 
204B) and press the SPACE bar. 



CATACAL Will accept data in USA-ASCII format with and without spaces 
and/or non-numeric characters before a numeric value (each number 
must be properly terminated, as described in Section 1.4). 
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4. Two parameters are requested by 

y RANGE & MIN: 

The range on the Y axis should be at least as 
large as the difference between the largest 
and smallest values on the tape. Type the Y- 
range, a comma, and the minimum value, which 
should be no larger than the smallest Y value 
in the data. Press the SPACE bar. 

5. The last question is 

TTY I/O? 

Answer Y if the data is coming from the low- 
speed reader. A reply of N will start the high- 
speed reader. Prepare the reader before reply- 
ing because the tape will be read in immediately 
after the reply. 



2 . 7 CALCULATE 



Spectra can also be calculated from the Teletype keyboard. CATACAL 
requests information on the peaks, the number of points, and baseline. 
The spectrum resulting from this calculation is displayed on the 
presently active channel. The CALCULATE procedure is as follows: 



1. Call the routine by typing CA: 

2. After the Teletype has printed the message 

ABSORPTION 'DIPS'? 

reply with Y if the spectrum is to be generated 
with dips; reply with N if it is to be generated 
with peaks. 

3. The next message is 

WIDTHS EQUAL? 

Type Y if all peak (or dip) widths are to be 
entered as equal; type N if unequal widths are 
to be entered (as specified in step 8 below) . 

4. Observe the Teletype for the message 

CUTOFF AT 8*WIDTH? 

If interaction from a peak that is more than 
eight times the halfwidth away from its posi- 
tion (or crest) is to be ignored, type Y. A 
considerable saving in time is gained for nar- 
row width, multipeak spectrums if Y is typed. 
Note that all peak widths must be less than 
l/4x(X RNG) (step 7) for this option. A res- 
ponse of N will include all interaction and 
impose no limits on widths. 
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Note that the messages in steps 2 through 4 are only asked for once 
each time CATACAL is loaded* 



5. Respond to the next message 

NO. POINTS= 

with a number less than 2jZf48 and press the SPACE 
bar. Note that both channels 1 and 2 are affected 
by this value; thus, if the CALCULATE operation is 
using channel 1, only that number of points will be 
available for display of the ddta in channel 2. 

6. After the message 

NO. PEAKS= 

type the desired number of peaks, in the range 
0<PEAKS<42. 

7. More data is requested by 

X RNG, XI, INT.MPLR, BASE, LOR. FR. (0-1) : 

The first three parameters allow the user to define 
any coordinate grid in which to contain the calcu- 
lated data. These parameters scale the data to a 
500 X 1000 point grid for compact integer storage. 
This does, however, impose a minimum on resolution, 
especially for peatk position and width, defined as 
X RtiG/500. Type in the parameters: X range, initial 
X location, multiplier which is the Y axis scaler, 
the location of the base line on the scaled Y axis, 
and the Lorentzian fraction where 0 is a 100% Gaus- 
sian fit and 1 is a complete Lqrentzian fit. The 
fraction must be in the range 0,0 to l.jZf. A value 
of 1 for INT.MPLR implies a range of 0 to 1000 on 
the Y axis, a value of 10 implies a range of 0 
to Ij2fj2f, etc. Base and peak heights should then fall 
within this scaled range. Peak positions should be 
in the range XI to Xl+X RNG. A negative X RNG is 
legal; e.g., for X1^500 and X RNG=:: -50j2f, the X axis 
runs from 5S50 on the left to 0 on the right. 

8. The dimensions of each peak requested next by the 
message 

HGT,H-WIDTH,POS: 

are height, half width at half height, and position 
on the scaled X axis. Type in each value followed 
by a comma or space and then press RETURN after the 
parameters for each peak. Thus, a two- peak spectrum 
may include the data: 

678,5,35 
789,4,5j2f 

If the equal widths option (step 3) is being used, 
enter a width for the first peak only. That value 
will be assumed for all other peaks. 
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9. 



After all the necessary data has been typed in, 
the computer indicates it is busy performing the 
calculation by the message 



COOL IT. 

on the Teletype. Do not type any key on the 
Teletype during the few seconds required for the 
computation; the keyboard is "dead". When cal- 
culated, the spectrum described by steps 2 through 
8 is displayed on the scope. 



After a display channel has been selected and data has been brought 
into the computer's memory, any of the following commands may be is-^ 
sued. Any number of them may be requested and in any order. After 
the data has been interpreted by any of the available commands, it 
can be stored on tape for later use. 



2 . 8 ALTER 



The parameters specified by the most recent CALCULATE command may be 
modified by an ALTER command. The command is implemented as follows 



1. Type AL: to call the ALTER routine. 

2. The message 

PK,PA,VL: 

is printed on the Teletype, requesting the peak in- 
dex number where the first peak typed in during 
CALCULATE is 1, the second is 2, etc., the parameter 
index where height is 1, half -width is 2, and position 
is 3, a comma or space, and the new value for that parameter. 
Type the peak number, a comma or space, the para- 
meter index, and the new value. Press the SPACE 
bar. All parameters except X RNG and XI may be 
altered. The equal widths option has no effect at 
this time; any width may be altered. Consider the 
following sequence: 

PK,PA,VL: 12,3,674 

This series will center the twelfth peak at loca- 
tion 674 on the scaled X axis. 



Other spectral parameters may be modified by typing one of the se- 
quences listed below and then the new value in response to the above 
message. 
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Sequence Parameter to be Modified 

0,li intensity multiplier 

0,2: baseline 

0,3 I Iiorentzian fraction 

N,j2f: print parameters for peak N 

0,0: print all parameters 



The last two sequences exit to the display without recalculating the 
spectrum- 

3. Type 0,-1: when all alterations have been made 
and the Resulting spectrum is to be calculated 
and then displayed* 

4. The CQjfiputer indicates it is recalculating 
the SE>§ctrum by printing the message 

COOL IT, 

on the Teletype. When it is completed, the new 
spectrum is displayed. 

2.9 COPY 

The contents of the currently displayed channel can be copied into 

another channel, leaving the two with identical data, by typing CO:. 
This is particularly useful if the manipulated data is to be compared 
with the original data. 

2.10 XINVERT 

The left to right X axis relationship of the displayed array can be 
inverted by typing XI : . 

2.11 YINVERT 

Each Y value of the displayed channel is subtracted from 1000 and the 
differences stored in that channel, thus effectively inverting the Y 
axis by the command YI : . 

2.12 SCALE 

If, when data is displayed on the scope, the maximum and minimum 
points "wrap-around" because they are out of the scope's range or if 
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the range is smaller than desired, SCALE may be used to bring the Y 
data into the range J2f<Y<^ljZf0jaf, The scaling parameters used, original 
minimum value, original maximum value, and multiplier, are printed on 
the Teletype after the computation, as, for example: 

MIN= -54 
MAX« 75 
MPY= 7.752 

where 

MPY=^ 1!3!50 and Y. = (Y.-MIN) x MPY 
(MAX-MIN) ^ ^ 

2.13 MULTIPLY 

Data may be scaled to an arbitrary range other than the 0 to 1000 
range assumed by the SCALE routine. The MULTIPLY routine is used 
mainly in spectrum stripping when a standard and/or background spec- 
trum is to be subtracted from a raw data set after appropriate scal- 
ing. 

The command is used as follows. 

1. Type MU: to call the MULTIPLY routine. 

2. The parameter 

MIN= 

is then requested. This value is to be subtracted 
from each data point before MPY is applied, as 

Y^=(Y^-MIN) MPY 

The final data should be in the range -2047 
to 2047,^. Values outside of this range 
are truncated to these limits. Final values 
less than -5 or greater than 1019 will "wrap- 
around" when displayed. 

3. When 

MPY= 

is printed, type in the desired multiplier. 

2.14 SMOOTH 

Collected data can be smoothed by an 11 point least squares curve fit 
routine via the SMOOTH command. The new spectrum is displayed on the 
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scope. The first and last five points are not altered • (This rou-- 
tine is a modification of DECUS 5/8-69.) 



2.15 CURSORS 

Typing CU; will display two movable bright dots, referred to as 
cursors, on the scope to be used to implement the INTEGRATE and STRIP 
commands^ by delimiting the data points to be modified. The two 
cursors are controlled by four analog channel knobs as follows. 

analog channel direction of 

CURSOR knob movement 

4 horizontal 
left 5 vertical 

6 horizontal 
right 7 vertical 

When the two dots appear on the display initially, knobs 4 and 5 must 
always position one of them to the left of the other. 

The decimal values of the location of the cursors are displayed at 



the top of the screen in the order 4,5,6,7. A grid of ^0^10 ^ "^^^^10 
on the scope is assumed ♦ The actual range extends slightly beyond, 
but the data points should be within that range. 

Typing CU: a second time will remove the cursors from the scope. 

Note that the cursors can be used to inspect peak amplitudes, valleys, 
widths, etc., by positioning them appropriately and noting the dis- 
played values. 

2.16 INTEGRATE 

The INTEGRATE command provides two options : 

1. Integrate the data between the cursors by using 
them to set a pivot or baseline, print out the 
area, and leave the data array unchanged. 



^A very slight distortion may occur on the scope when the cursors are 
used to delimit a portion of the spectrum at the extrema of the Xaxis. 
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2. Integrate all data using the cursors (extrapolated) to 
define a pivot line and store a scaled running integral 
in the data array, then print out a scale down multi- 
plier. 

The data is defined as lying on a 500 x 1000 grid, independent of the 
total number of points in the array. The area, at a given point, j, 
is expressed as 
j 

i»s 

where X^«0,X^=500 and s is the starting point which is 
X value of the left cursor for option 1 or is equal to 
2. Similarly, j=x value of the right cursor and is 
the pivot line at that point. 

An integration is performed as follows. 

1. Type CU: and position the cursors as required for 
the desired option (refer to section 2.15). 

2. Type IN: to call the routine. 

3. The message 

SCAN INT'L? 

is printed. Type Y if a running integral (option 2) 
is desired; type N if a partial integral and area 
printout (option 1) are desired. 

If, when the routine is first called, the message 
BAD X POINTS! 

is printed, the left-right relationship of the cursors has been in- 
verted. The display is restarted to allow correct positioning. When 
corrected, type IN: to call the routine again. 

2.17 STRIP 

Three options are available for altering portions of the displayed 
spectrum. 

1. Replace the data between the cursors with the best 
* straight line. 

2. Subtract a sloping baseline from all data points. 



equal to the 
0 for option 
the value of 
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3. Subtra<i?t a straight line interpolated between the 
cursors from the data between the cursors. 

The STRIP command is implemented as follows: 

1. Type CU: and position the cursors as explained 
below. 

2. Type ST: to call the STRIP program."^ 

3. The message 

STRIP PEAK? 



IS printed on the Teletype and the two dots are dis- 
played on the scope. If some of the data points are 
to be replaced by the best straight line, position 
the left dot at the first data point to be replaced, 
and the right dot at the last data point to be re- 
placed. Then type Y and the delimited portion of 
the spectrum is replaced by a straight line. The 
STRIP program is exited. Continue with another 
CATACAL operation. If one of the other STRIP opera- 
tions is desired, type a response of N. 

4. A reply of N generates the message 



PULL BASE? 



If a (sloping) baseline is to be subtracted from all 
the data points, the two dots should have been posi- 
tioned on the scope with the desired slope and ampli- 
tude. The dots need not be on the data curve nor on 
the X axis extrema because they are extrapolated. 
Type Y and the new display will appear. If a straight 
Ixne is to be subtracted from some data points, i.e., 
partxal baseline restoration is desired, type N. 

If, when the STRIP routine is called, the message 
BAD X POINTS! 

is printed, it means that the left and right dots have been inverted. 
The original display with the cursors appears. Correct the dots by 
adjusting the knobs; then call the routine again. 

2.18 DIFFERENTIATE 



The derivative curve of a spectrxam is computed by the DIFFERENTIATE 
command. Derivatives to a depth of at least six can be calculated 
for some spectra with minimal distortion of the data. These are 

^If STRIP is called without calling CURSORS first, stop and restart 
the program (refer to section 1.5) and call the CURSORS and then 
STRIP routines. 

2 

Note that the DIFFERENTIATE function is called by typing DE: 
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produced, not by adjacent point differences, but by the following 
procedure. 



y » y 



i+2 




with 



^1 ^ ^2 ^ ^3 



and Y, 



n'-2 



n-l 



S Y 



n 



If multi-depth derivatives are desired, scaling and smoothing are sug- 
gested before each level to reduce quantization error or "stairsteps" 
that result from integer arithmetic. It may also be necessary to 
strip out the first and last five points if they interfere with scal- 
ing (they are unaffected by smoothing) • 

2 . 19 PLOT 

Any displayed spectrum can be plotted on an X-Y recorder interfaced 
to a scope channel for a hard copy of that spectrum using the PLOT 
command. The size and rate of the plot are controlled by the user; 
the pen is controlled by relay 0. 

To generate a plot of the presently displayed spectrum, proceed as 



1. Type PL: to call the plotting routine. 

2. The first message printed on the Teletype is 

LINE PLOT? 

Type y if a line plot is desired or type N if 
a point plot is preferred. 

3. The plotting routine is now waiting for the 
user to calibrate an area on the X-Y recorder. 
A small dot appears on the scope and will make 
the same movements as the plotter pen. The 
speed for drawing the axes, as well as for the 
actual plotting, is controlled by knob 3 of the 
analog channel controls and may be adjusted at 
any time while using the PLOT command. Turning 
knob 3 clockwise increases the rate of plotting; 
turning it counterclockwise decreases the rate. 
The axes are calibrated by typing the following 
letters to perform the indicated operations. 



follows: 



Letter 



Operation 



X 



locates maximum X co-^ordinate 



Y 



locates maximum Y co-ordinate 



O 



returns pen to X-Y origin 
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The pen on the X-Y recorder should be set initially 

to the origin. Type X and then manually reposition 

the pen to the desired maximum X coordinate. After 

the X^^Y-j^' position has been determined, type 

Y. Set the pen to the maximum Y coordinate (X Y ) 

similarly » The axes have now been determined 

for the plot. Type O to move the pen automatically 

back to the origin (X^Y^) . 

4. The axes and quadrant markers of the graph may 
now be marked off on the plot if desired. Type 
M to mark off the frame and quadrants. Knob 3 
controls the pen speed. 

5. When the axes have been marked, the spectrum is 
ready to be plotted. Type G to initiate the 
plot. As before, analog channel knob 3 is used 
to adjust the plotting speed. 

Any characters other than X, Y, 0, M or G during 
this liequence produce a question mark on the 
Teletype and are ignored. 

6. When the spectrum has been plotted, the follow- 
ing message is printed. 

PLOTTER OFF? 

The plotter should be turned off or set to stand- 
by and then Y typed. If the plotter is not turned 
off, the pen will start to move wildly in its ef- 
fort to follow the scope analog signals when the 
display starts. 



2.20 SUBTRACT 



Using the SUBTRACT command, data in the displayed channel will be 
subtracted from data in the other channel. The result will appear 
in the displayed channel. The spectrum in the displayed channel 
will be lost; therefore, the TAPE I/O command is suggested before 
using this command if that data is to be used later. 



2.21 ADD 



The two channels can be averaged and the result seen in the displayed 

channel by issuing an ADD coxnmand. As with SUBTRACT, the data in the 
displayed channel will be lost when the ADD command is executed. 



2.22 SWAP 



The data currently in channel 1 can be placed in channel 2 and the 
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data in channel 2 placed in channel 1 with the SWAP command. This 
facility is especially useful with ADD and SUBTRACT. 



2.23 SQUEEZE 



The SQUEEZE command compresses the data array by a factor of 2 by 
averaging adjacent data points. It is recommended that this command 
be used immediately after data input (TAPE I/O, COMPUTER or AVERAGE) 
because the nxamber of points is halved for each issuance of this com- 
mand. If the current channel was 1 or 2, only that channel is 
affected, but if both channels were being displayed (3 was typed 
during display) , both are halved. The purpose of this command 
is to reduce the number of points in order to diminish flicker and 
allow faster smoothing, scaling, etc. 

2.24 MODIFY 



The CATACAIi program itself can be modified by a routine that is 
similar to ODT-8 (DEC- 8- COCO- D) to make changes in core locations. 
After calling the MODIFY routine, any of the following can be per- 
formed in a logical sequence. Each must begin at the left margin. 



open location 



change contents 



inspect next 
location 



teinspect same 



transfer control to 
any location 



Type the location (octal) and press the 
SPACE bar. The contents of that location 
are printed followed by a colon. 

After the present contents of a location 
have been printed, type the new contents 
and the letter C to enter the correction 
and press the SPACE bar. 

After pressing the SPACE ^st,r , type N. The 
next location and its contents can be 
printed followed by a colon. 

After pressing the SPACE bar, the con- 
tents of the last location opened can be 
printed again by typing S. 

Type R and the location and press the 
SPACE bar. Execution of the program will 
continue from that location. 



Pressing RUBOUT at any time will terminate the operation and restart 
the routine. 
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2.25 OUTPUT 



Collected data can be listed and/or output on paper tape by using the 
OUTPUT command. After calling the routine, the question 

TTY I/O? 

is asked. A response of Y implies the Teletype punch, and a res- 
ponse of N implies the high-speed punch. Be sure the device is pre- 
pared before responding to the question. The format is Ifi columns 
of four digit integers. 

2.26 RESTART 

The CATACAL pjtTPgram can be restarted from the beginning at any time. 
The message 

CATACAL LIVES 1 

is printed. This command is equivalent to pressing the START 20 key 
as described in Section 1.5. 

2.27 DIAL 

An exit from CATACAL and a return to DIAL are performed by typing 01:. 

Any DIAL commands can be issued at this time, including calling 

another program from the tape. Refer to the DIAL Manual, DEC-12-SE2B-D. 



^ DIAL refers to LAP 6 -DIAL • 
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CHAPTER 3 



CATACAL EXAMPLE 



The printout on the left side of the page is an actual CATACAL sequence. 
The commentary on the right was added to indicate the operation per- 
formed. Underlined information on the left is that typed in by the 
user. 



LP CATACALE>0 



LOAD CATACALE 



CATACAL LIVES! 
TITLE :DEM01 



PROGRAM IS READY 

NAME THIS SEQUENCE "DBMOl' 



OK, HIT MEi 



READY FOR A COMMAND. CHANNEL 
1 IS ASSUMED. 



ICA; 

ABSORPTION 'DIPS'?!? 
WIDTHS EQUAL7N 
CUTOFF AT 8*WTDTH?y 



CALCULATE SPECTRUM WITH 
PEAKS 

UNEQUAL WIDTHS 
CONSIDER INTERACTION 



NO. POINTS=l£g£ 
NO. PEAKS=:5 

X RNG, XI, INT.MPLR, BASE, LOR. FR. (^-1) 

lW,)g,l,^,j? 

HGT, H-WIDTH,POS: 

100, 5, m 

300. 10, m 

A00,iS,A00 ' 

100.11, m 



1000 POINTS 
5 PEAKS 

PARAMETERS FOR SPECTRUM 



COOL IT 

CO; 

lAL: 

PK, PA, VL; 1, 1,5^0 
PK , P A, VL : 2,2, 10 
PK,PA.VL; 3.3,8g(2f 
PK,PA,VL:flU-l 



COOL IT 
IT A; 

BLKT, U, M(0=W) : 200,1,0 
2TA; 

BLKl, U, M(0=W) i 210,l,0 
ITA: 

BLKT, U, M(i2f=W) : 21i?,l,l 

NO. POINTS^ 1000 
PTS. TO SKIP^g^ 
ISQ; 
ICU: 



UN: 



SCAN INT'L?N 
AREA=^ l?.1103/af9E+i2f6 
SM: 



SPECTRUM COMPUTED 

COPY DATA ONTO CHANNEL 2 

ALTER SPECTRUM ON CHANNEL 1 

ALTER HEIGHT OF FIRST PEAK TO 500 

CHANGE HALF WIDTH OF PEAK 2 TO 10 
CENTER THIRD PEAK AT LOCATION B00 
ALL THE CHANGES REQUIRED 

SPECTRUM COMPUTED 

PUT CHANNEL 1 DATA ONTO LINCTAPE 

STARTING AT BLOCK 200 UNIT 1 

PUT CHANNEL 2 DATA ONTO LINCTAPE 

STARTING AT BLOCK 210 OF UNIT 1 

GET DATA FROM LINCTAPE 

READ OFF UNIT 1 STARTING WITH 

BLOCK 21j2f 

READ 1000 POINTS 

SKIP FIRST 20 POINTS 

HALVE DATA POINTS ON CHANNEL 1 

DISPLAY CURSORS (POSITION CURSORS) 

INTEGRATE CHANNEL 1 

PARTIAL INTEGRAL REQUESTED 

AREA UNDER CURVE 

SMOOTH DATA 
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3'^ 



CO; 
CU; 
ST; 

STRIP PEAK?N 
FULL BASE?Y 
SC; 

MIN=- 52 
MAX= 1029 
MPy= 0.925 
MU; 

MIN==£ 
MPY= , 5 
2 IAD; 

OU: 

TTY I/0?N 
2AV; 

CHANNEL^l 

NO. POINTS=lj0[jef£ 
SEC/SCAN ==1^ 
SENSE: 15 

DELAY (SEC) =10 
NO. SCANS=3 

NO. SCANS=1 

MORE SCANS ?N 

3121MO; 

W7^3J?: 74020 

AV; 

CHANNEL^ 0 

NO. POINTS^ IfSfH 
SEC/SCAN« 16 
SENSE=15 
DELAY (SEC) =^ 
NO. SCANS=l2 



ITI: 

MCfTSEC) =1.72E"6 



MO: 

73^7=7402: 4 43jgC 

12SW 

SU; 

IPL; 

LINE PLOT?Y 
OXYOM 

G 

PLOTTER OFF?Y 
RE; 

CATACAL LIVES! 
TITLE :DEM02 



OK, HIT MEl 
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COPY DATA INTO CHANNEL 2 

DISPLAY CURSORS (POSITION CURSORS) 

STRIP OUT A 

(SLOPING). BASELINE' 
SCALE DATA 

PARAMETERS USED 



SCALE DATA TO ANOTHER RANGE 

WITH THIS MINIMUM AND THIS 

MULTIPLIER (AXIS IS HALVED) 

ADD DATA IN CHANNEL 2 TO CHANNEL 1 

OUTPUT THIS DATA 

ON HIGH-SPEED PUNCH 

ACQUIRE DATA IN DISPLAY CHANNEL 2 

INPUT FROM CHANNEL 1: 

Iff 00 POINTS, 

10 SECONDS/SCAN, 

TRIGGER VIA TELETYPE, START WHEN 

KEY IS PRESSED^ 

10 SECOND DELAY, 

3 SCANS MAXIMUM. TYPE A KEY. 

(BIT 0 SET) 

1 SCAN COMPLETED 

S IS TYPED BUT NOT ECHOED 

NO MORE SCANS DESIRED 

MODIFY THE PROGRAM 
LOCATION TO BE MODIFIED 
START PROGRAM AT LOCATION 4gfgf 
CALL AVERAGER TO TIME MEMORY CYCLE 
USE THESE PARAMETERS (BIT 0^0) 



TIME THE PR0GRAf4 FROM WHEN THE 

KEYBOARD IS STRUCK TO WHEN 

COMPUTER HALTS. 

CHANGE TIME OF THIS PROGRAM 

SET CONSTANT TO 1.72 MICROSECONDS 



RESTORE ORIGINAL CONTENTS 

TO MODIFIED LOCATION 

START PROGRAM AT LOCATION 400 

VIEW AND THEN SWAP CHANNELS 

SUBTRACT CHANNEL 2 FROM CHANNEL 1 

PLOT SPECTRUM ON X-Y RECORDER 

LINE PLOT 

CALIBRATE AXES THEN MARK BOX 

AND QUADRANTS 

PLOT 

DONE PLOTTING 

RESTART CATACALE 

PROGRAM IS READY 

NAME THIS SEQUENCE "DEM02" 



READY FOR A COMMAND 




PA: 

NO. POINTS" 600 
PTS TO SKIP«?f^ 
y RANGE & MIN: jM j ^fl 

TTY I/0?N 
XI: 

YI; 
PE: 

DI: 



READ IN FROM. PAPERTAPE 
600 POINTS 

START WITH FIRST POINT 

400 POINTS ON Y AXIS 

WITH MIN, VALUE OF 0 

VIA HIGH SPEED READER 

INVERT LEFT-RIGHT RELATIONSHIP 

ON X AXIS 

INVERT Y AXIS 

CALCULATE FIRST DERIVATIVE OF 
DISPLAYED DATA 
EXIT TO DIAL 
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APPENDIX A 
COMiMAND SUMMARY 



At least the first two characters of a command must be typed before 
colon is typed. 

INPUT-OUTPUT COMMANDS 

TAPE: Read or write LINCtape 

average: Accept time averaged analog data 

PAPERTAPE: Input data from paper tape or keyboard 

OUTPUT: Print/punch paper tape 

PLOT: Plot data on X-Y analog recorder 

PROCESSING COJfdANDS 

CALCULATE: Calculate Lorentzian and/or Gaussian spectrum 

ALTER: Alter parameters input by previous CALCULATE command 

COPY: Copy CDC into NDC 

XINVERT: Invert X axis 

Y I WERT Invert Y axis 

SCALE: Scale to range of 0-10i2f0 

MULTIPLY: Scale to arbitrary range 

SMOOTH: Apply eleven point digital filter 

CURSORS: Set up two cursors on scope 

INTEGRATE: Integrate between cursors or running integration (pre- 
ceded by CURSOR command) 

STRIP: Strip out data or baseline (preceded by CURSOR command) 

DERIVATIVE: Form differences (derivatives) 

SUBTRACT: Subtract CDC from NDC; results in CDC 

ADD: Add NDC to CDC; results in CDC 

SWAP: Swap CDC and NDC 

SQUEEZE: Average adjacent points of displayed channels 
SPECIAL COMMANDS 

MODIFY: ODT-like core modifier 

•^IME: Set machine cycle time constant to calibrate AVERAGER 

RESTART: Restart program 

DIAL: Exit to DIAL Editor 



CDC = currently displayed channel 
NDC = non-displayed channel 
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APPENDIX B 



ASSEMBLING CATACAL 



The CATACAL program is supplied to the user in both source and binary 
on the tape. To generate a new binary file if the source program is 
modified, use the following procedure. 



1. Load a DIAL-MS tape on unit 0. Load unit 1 with 
either a DIAL'-V2 or DIAL-MS system tape. If another 
tape unit is available, mount the tape containing 
the CLEARSYM and CATACAL source programs there. 

If only two tape units are available, place the 
source programs on unit 0 (with PIP if necessary) , 
in order to reduce the assembly time. 

2. Type -^Z'E^ to clear the binary Working Area of 
unit 1. 

3. Type -^AS CLEARSYM-^. CLEARSYM is a two word program 
which produces a clean symbol table. 

0000 
SAVSYM 1 



Type -^AS CAT2,0J. Error messages generated at 
this time should be ignored. Press the RETURN key 
to terminate the assembly after the errors have 
all been printed to suppress printing of the symbol 
code. 



5. 



8. 



Type -^ZE^. 
on unit 1. 



This clears the binary Working Area 



Type -♦'LI CAT3,0j . If no listing is desired, use 
the AS command. Any errors generated now are real 
and must be corrected. 

Type -►LI CAT2,0^. Because the symbol table pro- 
duced is the same as the one generated in step 6, 
printing may be suppressed with the RETURN key 
after it has started to be printed. 

Type -^B CAT23,0j . This saves the binary output 
from the two previous assemblies. 



9. Type >ZEJ . 

10. Two versions of the Floating Point Package are sup- 
plied. If the machine has the EAE option, CATIE 
should be used in the following steps and CATACALE 
will be generated. If the machine does not have 
this option, CAT2 should be used to generate CATACAL. 

11. Type -►AB CATl,0j. 

12. Type ->AB CAT23,0-', 

13. Type ->SB CATACAL, 0P J. A binary file of CATACAL (E) 
has now been generated and the command ->L0 CATACAL, 0^ 
will cause load and execute. 
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